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r) A client-server system for which applications 
programmers may easily write services and in 
which a relationship between a server and a 
service may be changed without halting the 
server. Both dient and server have access to 
copies of code for the service. The code has two 
parts : a caller portion which requests a service 
and a callee portion which executes the service. 
State variables in the dient process and the 
server process determine which portion of the 
code is executed. This mechanism permits a 
server to forward execution of the service to 
another server. The code for the service is 
written using a template which relieves the 
applications programmer of the need to write 
specialized code. The server provides the dient 
with a server namespace which is distinct from 
the server's system namespace. The dient can 
locate a service by means of a service pathname 
in the system namespace. The server further 
provides the dient with namespace manipu- 
lation services which permit the dient to add 
services to and remove services from a server 
and otherwise to manipulate the server names- 
pace without halting the server. 
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1 Background of the Invention * j 

1.1 Field of the Invention V 

5 The invention concerns data processing systems generally and more particularly concerns technioues for mak 
.n. appi.cat.ons programs to be executed in disputed computing sterns and 

1.2 Description of the Prior Art 

» SImhTT * 3 Pr ° 9fam WhiCh " eedS 3 C ° Py 0f a f i,e on the disk driv «. 0» second proce Jreouests 

rs that the first process send it the copy via the network. requests 

One way in which processes running in a distributed system may cooperate is as clients and servers Ser 
ver processes perform services for dient processes. To have a service performed ttelToZe^Jnl 
a message requesting the service to the server process; the server process t££^£%£% 
returns a message with the result to the client process. Thus in the above examnl* Ih- ! 

Asirnple model for communications between clients and servers is the remote procedure call In thL, ™h 
el. the Cent ca.ls a service in the server in the same way in which it would caH pS^ h it «eTu£ 
.tself. that ,s. the client ceases executing the procedure from which it made the ^eZesZ cSZ 
» cedure. and cont.nues execution of the calling procedure on return from the call. In x^e^ ^l 
wh.c .makes the remote procedure call ceases executing the procedure which made th ^ ca.,7owever s nL 
the S erv,ce .s remote, the call turns into a message to the server. The server then executes toewZsZ 

2? he » TF* f8tUrnS 3 meSSa9e ^ the reSU,t 10 the dient - *• clienteles «he m X 
with the result it resumes execution of the procedure which made the call 9 

30 . tf !h C,ie " t - Server n,odel for "operating processes and the remote procedure call are both widely 

usino 1 model ?* * r*" ^ ** P^mmer totl?SS2 

- Fo TlTt * areSeVera ' S ° UrCeS f ° rthediff iCU ' ty - FirSt there are the complexitiesof communS«on 
wh IT* *« thf0U9h the communica <™s system often have representations of thTdata 

been produced, or ,t may be done dynamically. In the second case, the binding may be done when Se server 

-5 the 1ST ° r T g eXeCUtl '° n - 8indin9 dUri " 9 eXeCUti0 " fe the ™* »-P'ex kW^JSS, bJSS 

becomes P oss.ble to maintain services in a server without shutting the server down * 

or J thefe r e t . he ! ° mplexities of service '«»«on. In order to achieve a higher'degree of fault tolerance 
or ,o balance system load, t » often useful to be able to have different servers execute the serv ce foT tS 

These complexities of communications, naming, binding, and location have at least two unfortunate con 
sequences: f.rst. they leave the applications programmer with the the choices of making do 2 a setof pZ 

* ^S^^^^T- 1" 0 "'- eVe " " aPP,iCa,i ° nS Pr ° 9rammer the 
.VT" ?! y 00 the SySteniS for which k is written - What is required and what the 

techn.ques d.sclosed herem provide, is a way of implementing services which is no more difTilt than imn.«! 
ment.ng an ordinary function and which produces reusable implementations P 
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2 Summary of the Invention 

The invention provides users of computer systems with techniques for implementing client-server systems 
which offer the following advantages; 

• it is as easy to implement a service as it is to implement a function in a standard programming language; 

• it is as easy for a client to specify a service in a server as it is for the client to specify a program in the 
client's own namespace; 

• the dient may add services to and delete them from the server and otherwise manipulate the server's 
namespace; 

• services may be added to or removed from a server without interrupting operation of the server; and 

• a server may either provide a service itself or forward the service to another server. 

Other objects and advantages of the apparatus and methods disclosed herein will be apparent to those 
of ordinary skill in the art upon perusal of the following Drawing and Detailed Description, wherein; 

3 Brief Description of the Drawing 

FIG. 1 is a diagram of a system of clients and servers which employs the techniques disclosed herein; 

FIG. 2 shows code for a service; 

FIG. 3 shows how code for a service is produced; 

FIG. 4 shows how a service is called; 

FIG. 5 shows how a service is forwarded; 

FIG. 6 shows predefined services provided by a server 

FIG. 7 shows a super server, 

FIG. 8 shows the data structure used to define a server's namespace; 

FIG. 9 shows how a server can be used to achieve fault tolerance; 

FIG. 10 shows details of a dient; 

FIG. 11 is a first detailed diagram of a server; and 

FIG. 12 is a second detailed diagram of a server. 

Reference numbers in the Drawing have two parts; the two least-significant digits are the number of an 
item in a figure; the remaining digits are the number of the figure in which the item first appears. Thus, an item 
with the reference number 201 first appears in FIG. 2. 

4 Detailed Description of a Preferred Embodiment 

The following Detailed Description begins with an overview of a system in which a presently- preferred embodi- 
ment of the invention is employed, continues with an overview of the dient and server, then provides details 
of how services are implemented, of how a server namespace is implemented, and of how server namespace 
operations are implemented, and finally describes a number of applications of the preferred embodiment 

i 

4.1 System Overview: FIG. 1 

FIG. 1 provides an overview of a preferred embodiment Distributed system 102 is made up of a number of 
computer systems 101(a,b,c.and d) are connected by communications system 105. Each computer system 101 
has a processor upon which one or more processes may be executed and a file system 103 in which files con- 
taining programs and data may be stored for use by the processes. When a process running on a system 101 
wishes to access a file in file system 103. it uses a name for the file in 10Vs system name space. There are 
four processes shown in FIG. 1 0, a dient process 1 07 and server processes 1 31 (a.b. and c) (henceforth, simply 
client 1 07 and server 131). In FIG. 10, the dients and servers are on separate systems 1 01 , but a given system 
101 may indude both clients 107 and servers 131. a server may have many dients. and the server and its 
clients may be on the same or different systems. Further, one server process 131 may be a client process 
1 07 for another server process 131. 

Server 131(a) provides three services 116 named A. 3. and C to dient 107; the services appear in FIG. 1 
as service A 116(1). service 8 116(2). and service C 116(3). There is service code 117 corresponding to each 
service 116. Code 11 7(1) for service A 116(1) is located on file system 103(c); code 11 7(2) for service B 116(2) 
is located on file system 103(b); code 117(3) for service 116(3) is located on file system 103(d). Furthermore, 
file system 103(a) has a copy of the code for each of services 11 7(1. .3). As will be explained in more detail 
later, service code 1 1 7 indudes code to be executed by a caller (client 107 or a server 131 operating as client 
107's agent) and a caliee (the server 131 which actually performs the service). Client 107 is able to locate 
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where * ^ ^ nameof the se ^er 131 and the name of a system 

which clfen,^ 
5 computer system 101 ^ 

and the server 131 As Zl Z ert^TZ MT * * om ™»«*«™ between client 107 

vers 131 and the file sv^ La f S n , *" M ° W ' S ' rVerS 131 are a,so accessil "« "om other ser- 

cessibie i that slrve'r 13 " ^ ""^ 3 MrVW ,ht 118 which lists ^ ^ ers 1 31 ac 

» ^comain^^ 

Server 131(a) can ^V^^^^ server 131. 
to another server 131. ^ 

namespace 133 establishes a corispondence L ZTJ * W " * SerVer 

the service which is in system 101fcT If ^mh„ .1 <T the Serv,ce and a »W of code "7 for 
'5 space 133 for server 1 31 ' ^ ^ PTOVide8 ,he Se ' Vice 116 " server " ame - 
anditsnamelnthena^ 

has the name B, and service 116f3> has th- nanJr iT. / V ( } name Al service 116 < 2 ) 

names in server namespac 13 S a hie^hT inci * ' embodiment, server 131(a) organfees the 
C"ent 107 can specif^ 

o the following form: y (a) by means of a serv,ce Pathname which has 

<computer_system_name>/<server_name>/<service name> 
Thus, if serverlist 118(a) indicates that server 1 31 t»\ ^ "- e -n ani e> 

- client 1 07 can specify service A bZZm££~- {) " a " d ' S °" 1,16 system cal,ed u ^or, 

In a preferred embodiment, client 107 executes a QAiWa ne u„ ~ 
»1e 117 r„ ,h, s „vic. 1,6. Thar poZ7£j£££ 1,7 m IT' ""f"" POrt, '°" °' Se, * s 
<ar 9 J.->. <™s* („„«,„ which J, m ^.""e' T^tH" f!""^' <Pa " , - P "'' 

needs to execute the Service ^t^L ! ( \ ,7™"*" 133 C ° ntains the infor ^tion server 131(a) 

ft* A*nT? h s TZ^ZiZ^Z an ° ,her SefVer 131> " ameSpaCe 133 a 
other server 131. ' ^ m Server "amespace 133 belonging to the 

execution of the pa rt ^117 which'to be eTf, " ?* feSU,tS * dient 1 ° 7 ' Which then «"*•«- 
service, server 131(a) execut he ortio X^J^ZS^T" ™ " * ^ 
pathname provided by server namespace "iT slZZr^ , J* thS Ca " er - but uses the link 
received from client 107 In the is^c! JS- Se ™<*Call along w,th the arguments which server 131(a) 

vided by server 13 b] 0 ystfj 1 nZTZL " a,neSPaCe 133 indiCa,eS ** the Service 116 is 

to server 131(a). which in turn returns kto^^^l^S^? ™e result message is returned 
'^invocation of Serv^^ 



4.2 Service Code 117: FIG. 2 



provide the service 116 has acces h ! 116: Simi ' arly ' each servef 131 " hich can 

both may use the sam copy of ZZ c2 u 7 ^ 131 - ^ Same SyS,em 101 - ^ 
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to or removed from server 131 without interruption of operation of server 131. In other embodiments, service 
code 117 used by dient 107 may also be dynamically linked. 

FIG. 2 shows details of service code 117; in a preferred embodiment it has 6 parts: 

• Argument converter 201 is code for encoding the arguments for the service 116 into a form suitable for 
use by communications system 105 and decoding the arguments as received from communications sys- 
tem 105 into a form suitable for use by dient 107 or service 131; 

• Result converter 203 is code which does the same for the results of the execution of service 116. 

• Init 205 is code which is executed when service code 117 is installed in a server 131; 

• Function 207 is code for the function performed by the service 116 implemented in service code 117; 
it indudes two subparts; 

- Caller code 210, which is executed by a client 107 or a server 131 which is calling a server 131; and 

- Callee code 213. which is executed by server 131 which actually provides the service. 
Converters 201 and 203 are necessary because the networks used in modern distributed systems typically 
represent data as a stream of bytes. Consequently, the arguments for the service 116 and the results from 
the service 116 must be translated between the forms which are required in the systems in which service 116 
executes and the forms required by the network. In the preferred embodiment the code for argument converter 
201 . result converter 203. and init 205 is provided automatically when service code 1 1 7 is generated; the person 
writing service code 117 need only supply the code in function 207. 

Caller and callee code are written in a preferred embodiment as branches of an if statement The function 
used in the rf statement lsCaller() 209. is a special function used to implement system 1 02. It returns one value 
if service code 1 1 7 is being executed by a caller and another if service code 1 1 7 is being executed by a callee. 
In the case of execution by a client 107. the function always returns the caller value; in the case of a server 
131. the function returns the callee value unless the server is forwarding the service request in that case, it 
returns the caller value. 

4.3 Writing Service Code 117: FIG. 3 

FIG. 3 shows how Service Code 117 is written in a preferred embodiment There are four steps: 
« Specifying Service Interface 

The preferred embodiment employs an extension of a remote procedure language used in Sun computer 
systems to specify the service interface. The specification defines data structures of input arguments and 
output results in a C-like syntax. It also declares a service function with the syntax: 

"servic*" type-spedf ier identifier "(■ type-specifiers •)";' 
where "service" is a keyword, the first •type-specifier" specifies the type of the value returned by the service 
function, the "identifier* specifies the name of the function and the "type-specifiers* in parentheses specify 
the types of the function's arguments. 

• Generating RPC Stub and a Service Template 

Service code 117 is written using a service compiler, called ServiceGen 303. which takes a service inter- 
face as input (i.e.. spec.x 305. and generates three outputs: XDR routines (i.e.. the file xdr.c 307). which are 
argument converter 201 and result converter 203 in a preferred embodiment a template (i.e., the file template. c 
309) which a programmer can edit to implement the service function; and an initial function (i.e., the file initc 
311) which contains code used when the service code 117 is installed in a server 131. 

• Implementing the Service Function 

application programmers implement the service function by editing (3 1 3) template 309 to produce the code 
for the service function servicex 315. 

• Creating a Service Library 

Service code 11 7 is generated by compiling and linking service function 315, which becomes function 207. 
xdr routines 307, which become argument converter 201 and result converter 203. and initial function 311. 
which becomes init code 205. Switches on the compiler permit compilation of service code 117 in forms which 
permit its incorporation into the server or dient program at link time, at system initialization time, and at run 
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time. 



vice f unS l7«^ZT!l Z SPedfying SefViCe interface and im P»— «"B *• ser- 

■SSS^S^ni^ ? app .cations programmer the XDR routines 307. the template 309. 
ana tne initial function are all provided automatically by ServiceGen 305. Consequently the aoolications JL 

£==== L^=^^^»JK5a== 



307, and the init routine 311 to the compiler. 
4.4 Example of Implementing Service Code 117 



IpO SSfSSX rel^rr 06 ^ ^ 301 may be used to implement a service 

The service interface for cpQ is the following. 



struct IaArguaent 
{ 

char froa[l28]; 
char to [128]; 

}; 

service int cp (In Argument) ; 



Z£££ZT£££ m ,0 " h9 m s "-° «• - • *— « * «• 
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20 



bool.t XdrlnArguaeatO; /• XDR Function for input: InArguaent ./ 
bool.t XdrlntO; /♦ XDR Function for output: int •/ 

int init (pathname) 
char "pathname 

caddr.t cp(); /• service function */ 

int init (pathname) 
{ 

if (creatnode (pathname, SERVICE, cp, XdrlnArgument . Xdrlnt)) 
return (0) ; 

else 

return (-1); 

> 



25 



30 



This function is invoked by server 131 when the service 116is linked by server 131. It calls a function, crea- 
tnode(), which puts the name cp into server namespace 133. As will be explained in more detail later, each 
name in namespace 133 is represented by a node, and creatnodeO creates such nodes. The function takes 
five arguments: the part of the service pathname following the server name, the type (SERVICE, LINK, or DI- 
RECTORY) of the node, a function pointer to function code 207, a function pointer to argument converter 201 . 
and a function pointer to result converter 203. 
Template 309 forcp() looks like this: 



35 



40 



■is 



so 



55 
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int* cp(argp, objp) 

struct InArgument *argp; 

•objp; 



{ 



10 



char 



static int res; 



15 



20 



25 



30 



35 



40 



> 



if (IsCallerO) 
{ 

U (ServiceCalKobjp, argp, ires) ! -SUCCESS) 
return (NULL); 

" else 



return (ires) ; 



} 



/* iapleaent the service here*/ 
return (ires); 



of the Z S I ' : • fUnCti ° n 207 indUdeS tW ° parts: «"« code 210 and cal.ee code 213 Each 

of the parts » a branch of an Statement, and as can be seen above, the value returned by th." notion 
erOindicateswh.ch branch is executed. Theva.ue returned by that function indicates whether S eS 
207 ,s be,ng rnvoked by a caHer or callee and also determines whether caller code 210 o ca Z ^e 213 * 

to be implemented at the point indicated by the comment, r implement the service here*/ Cdle r ZTZ 
contams Serv.ceCall function 210. which actually invokes the service 207 on a server 131 

As can be seen from the above, the template makes implementing a service function 207 as easv as im- 
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iat* cp(argp, objp) 

struct InArguaent «argp; 
char *objp; 

{ 

static iat res; 
iat rfd; 
iat vfd; 
iat length; 
char buf[l024]; 



20 if (IsCallerO) 

{ 

if (ServiceCalKobjp, argp, ftres) !=SUCCESS) 
25 return (NULL); 

else 

return (Ares) ; 

30 



35 



40 



45 



50 



55 
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+ 
♦ 
+ 

w 

+ 
+ 

1$ 



20 



+ 
+ 



if (Crfd = op«n(»rgp->f PO « l O.RDONLY)) < o || 

(vfd = open(argp->to, 0_ CHEAT | O.WRONLY, 0600)) < 0) 



{ 

res = errao; 
return (4res); 

> 



vHile ((length - read(rfd. buf . 102 4)) > 0)) 
write (vfd, buf, length); 



close (rfd); 
25 + close (tffd); 



res = 0; 
return (Ares) ; 



30 } 



4.5 Implementation of Client 107: FIG. 10 

* bodiment executes object cede taT^ZoT^r^^ ^ C "' ent 107 3 Prefemid em " 
code 117. Linked to the object code fo t^^Z^Zl ^ ^ T** imp,emented * servi <* 
ler() function 209. object code fdrlhe Sa^lSS , 1 S6rV ' C8 C ° de 1 1 7 * ° bjeCt 00(16 for the ,sCa| - 

cedure call. FIG 0 Ih^ZZaZ^Z^f T ' ^ ,0Ta *#"*P™*«i remote pro- 
of dient 107. i^^ti^'s^^'? of r r a code 117 and ,he 

« variable ME 1007 In client 107 ME StS! ? f ° fUnCt '° n 209: the va,ue a returns is kept in state 
Servicecall function 2 J : ^ bX^7o~ d ^T "Sf?" 1016 " ° bjeCt for 
in the invocation of ServiceCall 101 « h Tm J at * U ™ ntS Spedfied 

service 116. and server .ist 118. wh^ti.^^t5 o t^ ""^ °' ^ eXeCUti0 " ° f 



seen 



- Wici OlUUi lU^J. 

... Sire ™^Sr u,e r d,,m 107 ,M -*• 
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code contains an invocation 211 of ServiceCall 1016. The invocation specifies service pathname 116, which, 
as previously indicated, includes the system 101 upon which server 131 executes, the name of server 131 and 
the pathname of service 116 in server 13Vs namespace, arguments 1003 for the service 116. and buffer 1004 
for the results of the execution of the service by the server. For example, if the system name is condor and 
the server name is dscs and the pathname in dscs's server namespace 133 /bin/cp. the service pathname 
will be /condor/dscs/bin/cp. 

Service call 1016 places the arguments for service 116 in Args 1003. uses the server name in the path- 
name to find the network address for the server in serverlist 118, and then invokes remote procedure call 1017. 
The invocation specifies as arguments the network address, the pathname for the service in the server name- 
space 133, arguments 1003. buffer 1004 for the result, argument converter 201 . and result converter 203. Re- 
mote procedure call 1017 uses argument converter 201 to put the arguments for service 116 into the proper 
form for the communications system, then makes a call message addressed to server 131 which contains the 
service path name and the encoded arguments, and finally sends the call message 1019 to server 131. 

When server 131 is done executing callee code 213, it sends a return message 1021 to RPC 1017 which 
contains the results. RPC 1017 uses result converter 203 to decode the results, places the decoded results 
in results buffer 1 004. and returns to ServiceCall, which in turn returns to caller portion 21 0 of service function 
207. Execution of caller portion 21 0 is then completed. Typically, completion of execution of caller portion 210 
involves returning the contents of results buffer 1004 to the execution which invoked service function 207. 

4.6 Implementation of Server 131: FIG. 11 



Fig. 11 shows details of those parts of the implementation of server 131 which are directly involved in the exe- 
cution of a service 116. Server 131 has its own copy of service code 117 for the service 116 and additionally 
includes a caller stub 1023 with the same components as caller stub 1023 in dient 107. Caller stub 1023 and 
the other components of server 131 which are directly involved in the execution of service 116 together make 
up callee stub 1103. The most important additional component of callee stub 1103 is dispatch 1105, object code 
for a function which responds to a call message 1019 from a dient 107 by executing service function 207 for 
the service 116 spedfied in the call message. 

Continuing with a more detailed description of the implementation of server 131. the call message 1019 
received in dispatch 1105 specifies the service pathname in server namespace 133 of service code 117. dis- 
patch 1105 invokes a function. FindService. in server namespace 133, which takes the service pathname 1117 
for the service and returns information 1119 specifying where the service is to be provided. Next, dispatch 
1105 invokes decode function 1109. which takes the message and a pointer to argument converter 203 and 
decodes the arguments in the message and places them in Args 1115. Thereupon, dispatch1105 determines 
whether information 119 spedfies that the service is to be provided by server 131 or another server 13V. In 
the latter case, the information indudes a link pathname for the service which specifies the service pathname 
for the service 1 1 6 in server namespace 1 33' belonging to server 13V. When the service 1 1 6 is to be provided 
by server 131. dispatch 1105 sets state variable ME 1111 to specify a callee; otherwise dispatch 1105 sets 
state variable ME 111 to specify a caJler. Thereupon, dispatch 1105 invokes service function 207 with the ar- 
guments in Args 1115 and a service pathname, as shown by arrow 1121. If the service 116 is to be provided 
in server 131. the service pathname is the pathname for the service 116 in server 131*s server namespace 
1 33; if it is to be provided in server 1 31 \ it is the pathname for the service 1 1 6 in server 131 M s server namespace 
133'. 

As described in the discussion of dient 107. whether caller portion 210 or callee portion 213 of service 
function 207 is executed depends on the value returned by IsCaller 1005 of caller stub 1023, which in turn 
depends of the value of ME 1111. Thus, if service location 1119 specifies a location on another server 13V. 
dispatch 1105 has set ME 1111 to indicate a caller, and caller portion 210 is executed with service location 
1119 and arguments 1115 as arguments for ServiceCall 1016. The invocation of ServiceCall1016 proceeds 
exactly as described for client 107. except that the results which ServiceCall 1016 receives from RPC 1017 
are placed in results buffer 1113 and that the function which resumes execution on return from caller portion 
210 is dispatch 1105. as shown by arrow 1123. 

If information 1119 specifies that server 131 is to provide the service 116. dispatch 1105 has set ME 1111 
to indicate a callee. IsCaller so indicates, and callee portion 213, which contains the code which performs the 
actual function for the service, is executed using the contents of Args 1 1 3. The result of the execution is placed 
in Results 1113. and the return is to dispatch 1105. Regardless of whether caller portion 210or callee portion 
213 was executed, dispatch 1105 uses results converter 205 to encode results 113 and sends the encoded 
results in a return message 1021 to the source of the remote procedure call, which may be a dient 107 or an- 
other server 131. 
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4.7 Calling and Forwarding a Service 116: FIGS. 4 and 5 

Thu when u sert iZlL ? * Va ' Ue ' mdiCat '' n9 ** Service code 117 is b «"9 >V a caller 

function 207 and ZS" T "TJ " 117 ' P ° rtto " 210 

01 * e ServiceCa " ,unction 211 resu,ts in ca,lerstub 1023 

' Ca "" ponlon m ™ *> «" In call., stub ,103 of £Z 13?m 

ror a service 116 from being forwarded around a loop of servers §j 31. ■ M 

4.8 Implementation of Server Namespace 133: FIG. 12 f " ^ ' " 

FIG. 12 presents an overview of the implementation of server namespace 133 for a server 131 in a overran 

«*. patli n»™ s , 117 »*, £Z ° » 

1M ann fh- MIM ' " wh,ch P erform s mapp.ng between service code 117 in disk drive 

a™ 1202 " ameSPaCe Pnn,itiVeS 1203 t0 P6rf0rm ,he actual -anipu.ations. as shown £ 

4,8.1 Hierarchy Representation 1212: FIGS. 12 and 8 

Continuing in more detail with hierarchy representation 1212. representation 1212 is a tree with three kinds 

12 
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of nodes 1206: directory nodes 1207, which represent directories in server namespace 133. service nodes 
1209. which represent services 116 which are executed by this server 131. and agent nodes 1211, which rep- 
resent services 116 which are executed by other servers 131 for this server 131. FIG. 3 shows how nodes 
1206 are implemented: each node has two parts: a node structure 801. which represents the node itself, and 
context structure 803. which represents either the directory or the service 116 represented by node 1206. FIG. 
8 also has a detail of node structure 801: it contains name 804, which is the name in server namespace 133 
represented by node 1206. attributes 833. which indicates attributes of the node, parent pointer 807. which 
points to the parent of node 1206 in hierarchy representation 1212. and cont ptr 809. which points to context 
structure 803 for the node. 

The attributes include the node 1206*s type in field 805, and in the case of service nodes 1209. they also 
include mapped bit field 835. which indicates whether the service node is mapped to a file containing service 
code 117, and if the node is not mapped, file attributes for service code 117. The file attributes include the 
last time service code 117 was accessed by server 131. in field 837, the time the file containing service code 
1 17 was created, in field 839, and an access control list in field 841. The access control list is a list of the users 
allowed to access the service. 

The contents of a context structure 803 for a service are shown at 611. The first three fields are set when 
service code 117 is loaded into the memory of system 101 upon which server 131 is running, func _ptr 813 is 
a pointer to function code 207 for the service; in_decj)tr 815 is a pointer to argument converter 201 and 
out_dec_ptr is a pointer to result converter 203. SL path 819 is the system path name of service code 117 in 
file system 103. The system path name is used by service linker 1205 to locate service code 117 in file system 
103. SL_handle 821 is the value returned by file system 103 when service linker 1205 opens service code 
117. Linkjnfo 823. finally is used when node 1206 represents an agent 1211. In that case. Linkjnfo 823 con- 
tains a service path name for service 116 in server 131" which is to provide the service 116. 

The contents of a context structure 803 for a directory are shown at 825. The first field. map_path 827, 
is used to map a directory name in server namespace 133 to a directory name in file system 103. When this 
has been done, server 131 automatically adds services 116 with service code 117 in the mapped directory to 
its server namespace 133. The field contains the system path name in file system 103 of the directory which 
corresponds to the directory in server namespace 133 to which context structure 803 belongs. The remainder 
of the fields in context structure 827 are pointers to the nodes 1 206 which represent the services or directories 
in the directory represented by dir_struc 825. There is a node_ptr 831 for each service or directory, and the 
list of pointers makes up node_ptrJist 829. 

4.8.2 Details of Namespace Primitives 1203 

The primitive operations in server namespace 133 fall into two classes: locating a node 1206 when given the 
path name for the entity represented by the node and adding and removing nodes 1206 in hierarchy represen- 
tation 1212. 

The primitive for locating a node is namei. nameitakes a pathname in server namespace 133 as as an 
argument and returns a pointer to node 1206 which represents the pathname. The function begins at the root 
of hierarchy representation 1212 and works down the pathname and hierarchy representation 1212 a compo- 
nent at a time. If namei either runs out of names in the pathname or runs out of nodes in representation 1212. 
or finds a service node 1209 or an agent node 1211. it returns the pointer to the current node 1206 and any 
remainder of the pathname. 

The primitive which adds a node is called creatnode. Its arguments include the type of the node and in- 
formation required to fill in the relevant fields of node structure 801 and context structure 803. The primitive 
creates a node structure 801, fills in fields 804, 833, and 807, creates the proper type of context structure 
803, fills in fields of the context structure as required by the node type, and fills in field 809 of node structure 
801. The primitive which removes a node simply unlinks node structure 801 from hierarchical representation 
1212, updating node_ptrJist 829 in the parent of the removed node 1206 as required. 

4.8.3 Using the Primitives 

The primitives are used to execute a service 116 and to perform namespace services 1201. As previously de- 
scribed, executing a service is carried out in server 131 by dispatchHOS. a component of cailee stub 1103. 
dispatch receives a message with a service's path in name space 133 and uses the function FindService to 
find the service. FindService uses namei to move down hierarchical representation 1212 until it reaches a leaf 
node. 

What happens then depends on the node type. If the leaf node is a service node 1206 or a an agent node 
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the node 1206 specified by the service pathname, and the information returned by the services is then ob- 
tained from the specif ied node. In the case of stat the information is always the node's type 805 and the setting 
of its mapped bit field 835 from node structure 801. If mapped bit field 835 indicates no mapping, the infor- 
mation further indudes the contents of access time field 837. create time field 839. and access control list 

5 field 841. If mapped bit field 835 indicates mapping, this information is obtained from the file which contains 
service code 117. setstat623 permits mapped bit field 835 and the contents of fields 837-841 to be set by a 
client 107. The arguments are the service path name for the node and the values to which the attributes are 
to be set. The function uses namei to locate the node 1206 and then sets the relevant fields from the values, 
getservice 625 and putservice 627 permit service code 117 to be uploaded from a client 107 to a server 

10 1 31 and downloaded from a server 1 31 to a dient 107. Uploading is done by putservice 627. which takes as 
its arguments a service path name for the service 116 and a buffer with service code 117. Server 131 performs 
the function by creating a file in its file system for service code 117 and creating a service node 1206 for the 
service 116 which specifies the file, containing the uploaded service code 117. Downloading is done by get- 
service 625. which takes two arguments: the service path name for the service 116 and a buffer for service 

is code 117. In server 131. getservice uses namei to locate service node 1209 for the service 116. uses the in- 
formation in service node 1209 to locate service code 117, and sends service code 117 back to dient 107. In 
client 107. the service code is moved from the buffer to a location in the system name space of dient 107 and 
is then dynamically linked to the code being executed by client 107. 

20 4.9 Applications of Servers 131: FIGS. 7 and 9 

Servers 131 may be used in a number of ways to solve problems of distributed systems. One such problem 
is fault tolerance. As shown in system 901 of FIG. 9. A server 131(a) can forward a request for a service to 
any of a number of servers 131(b..n). Consequently, server 131(a) can respond to a failure by one of the ser- 
vers 131(b..n) by using symlink 609 to change the agent node 1211 for the service so that the the request for 
the service is forwarded to a working server 131. 

Forwarding requests for services can also be used to balance loads among servers 131(b..n). Server 
1 31(a) need only keep track of how many requests have been forwarded to each of the servers 131(b..n) and 
change the agent node 1211 as required. Such load balancing may of course also be responsive to other in- 
formation such as the state of the systems in which servers 131 (b..n) operate or the time of day. In some em- 
bodiments, link info 823 can be a pointer to a scheduling function which determines which of the servers 
1 31(b..n) the service request is to be forwarded to. 

The fact that a service 1 1 6 is accessed by means of server n amespace 1 33 also makes dynamic updating 
of services easy. All that need be done when a new copy of service code 117 for a service 116 becomes avail- 
35 able is use rmservice 605 to remove the old service 116 from server namespace 133 and then use either 
mkservice or putservice 627 to again place service 116 in server namespace 133. mkservice is used when 
client 107 and server 131 share a system name space and putservice is used when dient 107 and server 131 
belong to different system name spaces. Access by a dient 107 to a service node 1 209 which is being changed 
can be avoided by the use of one many locking mechanisms. 

One way of taking full advantage of the possibilities opened up by servers 131 and services 116 is to in- 
clude a super server in the distributed system FIG. 7 shows a distributed system 701 with a super server 703. 
Like an ordinary server 131. super server 703 has a file system 103(a) with service code 11 7(a..n) for a number 
of services. Super server 703 of course also has a server namespace 133 with nodes 1206 for the services. 
The difference between super server 703 and a server 131 is that super server 703 distributes services 116 
•*5 as well as executing them. 

One way in which such a super server 703 can be used is to distribute services 116 to dients 107. To re- 
ceive a service 116. the dient simply uses getservice 625 to get its copy of service code 117 for the service. 
Another way in which such a super server can be used is to distribute services 116 to other servers 131. When 
super server 703 is being used this way. it responds to a request by dient 107 to execute a service 116 0) 
whose code is induded in code 117(a..n) by downloading code 1170) for the service 116 to a server 131(i) of 
servers 131 (0..m) (arrow 709) and setting server namespace 133 in super server 703 so that requests for 
service 116(j) are forwarded to server 131(i). The downloading is of course done using putservice 627. 

In another embodiment super server 703 responds to a request for dient 1 07 for mkservice 605 for a ser- 
vice 116(i) by downloading service code 117(i) for service 116(i) to a server 131(k) in servers 131(0..m) and 
returning a handle 707 for service 116(i) in server 131(k) to dient 107. The handle is of course the name of 
server 1 31 (k) and the pathname of service 1 1 6(i) in server 1 3 1 (k)'s name space. CI ient 1 07 can then use handle 
707 to directly request server 131(k) to execute service 116(i). Super server 703's choice of a server 131(k) 
can of course be made from the point of view of load balancing. Similarly, if server 1 31 (k) fails, dient 1 07 need 
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in thp nr/uiram 



in the program, 
a caller portion (210) 
a cailee portion (213). and 



a canee portion (213). and 



The apparatus set forth in claim 1 further characterized by: 
another process (131(a)); 



3. Tli. apparatus set forth in daim 2 further characterized in that 

.he program funher include, an initiation ponion ,205, which b e.ecutw by ,„. 0 , h „ 
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in order to install the program in the namespace. 

4. The apparatus set forth in claim 2 further characterized by: 

a further process (131(b)), the further process having message receiving means like those in the 
other process; 

and wherein 

the other process has means (1023) responsive to the caJler portion for sending a message (1019) 
to the further process requesting that the further process execute the program; and 

the means for receiving the message determines whether the callee portion is to be executed by 
the other process or the further process and causes the determination to indicate a callee process in the 
first case and a caller process in the second case. 

5. The apparatus set forth in claim 4 further characterized by: 

namespace means (133) accessible to the other process for relating a first name identifying the 
program either to a location of a copy of the program or to a second name identifying the further process: 
and 

the means for receiving the message determines whether the called portion is to be executed by 
the other process or the further process in response to the namespace means. 

6. The apparatus set forth in claim 2 further characterized in that 

the apparatus is implemented in a distributed computing system including a plurality of processinq 
nodes (101); 

the process and the other process execute on different ones of the nodes; and 
the means for sending a message sends the message from the node upon which the process is 
executing to the node upon which the other process is executing. 

. The apparatus set forth in any of claims 2. 4, or 5 further characterized in that 

the means responsive to execution of the caller portion includes means (1023) for receiving a return 

message from the other process with results of execution of the program; and 

the means for receiving the message includes means (1016) for sending the return message with 

the results to the process. 

The apparatus set forth in daim 7 further characterized in that 

the means for sending a message, the means for receiving a message, the means for sending a 
result message, and the means for receiving a return message are provided by remote procedure call 
means (1017). 

The apparatus set forth in daim 7 further characterized in that 

the message and the return message employ a first representation of the data which is different 
from a second representation of the data employed in the computer system; r 

the message includes an argument value; 

the return message returns a result value; 

the program further indudes 

an argument converter portion (201) and 

a result converter portion (203); 

the means for sending a message and the means for receiving a message use .the argument con- 
verter portion to convert argument values between the first representation and the second representation; 
and 

the means for sending a return message and the means for receiving the return message use the 
result converter portion to convert result values between the first representation and the second repre- 
sentation. 

I. A client-server system of the type wherein a server process (131) executing in a computer system provides 
a service for a client process (107), the dient-server system being characterized by: 

server name space means (133) employed by the server process to relate a name for the service 
to means (117) for providing the service, the name being part of a server namespace distinct from any 
system namespace provided to the server process by the computer system. 

service calling means (1016) employed by the dient process to send a message to the server which 
indudes the name for the service; and 
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The client-server system set forth in claim 10 further characterized by- 
The client-server system set forth in claim 11 further characterized by: 
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© Methods and apparatus for making and using distributed applications. 



) A dient-server system for which applications 
programmers may easily write services and in 
which a relationship between a server and a 
service may be changed without halting the 
server. Both client and server have access to 
copies of code for the service. The code has two 
parts : a caller portion which requests a service 
and a callee portion which executes the service. 
State variables in the client process and the 
server process determine which portion of the 
code is executed. This mechanism permits a 
server to forward execution of the service to 
another server. The code for the service is 
written using a template which relieves the 
applications programmer of the need to write 
specialized code. The server provides the client 
with a server namespace which is distinct from 
the server's system namespace. The client can 
locate a service by means of a service pathname 
in the system namespace. The server further 
provides the client with namespace manipu- 
lation services which permit the client to add 
services to and remove services from a server 
and otherwise to manipulate the server names- 
pace without halting the server. 
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